{{tag>hardy jaunty bureautique travail_collaboratif BROUILLON}}

----

====== OBM-UI ======

===== Présentation =====

OBM est une solution logicielle Open Source de travail collaboratif, intégrant les meilleurs composants libres pour gérer et partager les informations au sein d’une organisation. OBM-UI est l'interface web de base de cette solution.

OBM-UI fournit :

  * une interface de gestion des utilisateurs et des ressources.
  * un agenda partagé/partageable (interface web en ajax).
  * une gestion simplifiée des tâches.
  * une gestion de contacts (publics et privés).

===== Pré-requis =====
  * Disposer d'un SGBD ([[/mysql|MySQL]] ou [[postgresql|PostgreSQL]]) - cette documentation ne traitera que du cas particulier de MySQL.
  * Disposer d'un serveur web opérationnel : [[apache2|apache2]] avec php et [[tutoriel:securiser_apache2_avec_ssl|configuré avec ssl]].

(pour ceux qui ne savent pas faire, le plus simple est d'installer les paquets ainsi :
''sudo apt-get install mysql-server apache2 phpmyadmin'')

===== Installation =====

Télécharger les sources sur le [[http://obm.org/doku.php?id=downloads:source:sourcedownloadslist|site communautaire obm.org]]. Les extraire dans un répertoire accessible par apache (nous utiliserons /var/www/obm pour ce tutoriel). Modifier le propriétaire et le groupe pour les fichiers d'obm.

<code>
wget http://download.obm.org/obm-2.2.x.tar.gz
sudo mv obm-2.2.x.tar.gz /var/www
cd /var/www
sudo tar xzf obm-2.2.x.tar.gz
sudo mv obm-2.2.x obm
sudo chown www-data.www-data obm/ -R
</code>

===== Configuration =====
==== Configuer Apache ====

Le mieux est d'utiliser un virtualhost. Pour cela, créer un fichier ''obm'' dans ''/etc/apache2/sites-available/'' avec les informations suivantes (le serveur sera accessible via le nom obm.mondomaine.tld) :

<code apache>
<VirtualHost *:80>
        ServerName obm.mondomaine.tld
        DocumentRoot "/var/www/obm/php"
        ErrorLog /var/log/apache2/obm-error.log
        CustomLog /var/log/apache2/obm-access.log combined
        rewriteengine on
        RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [L,R]
</VirtualHost>

<VirtualHost *:443>
        ServerName obm.mondomaine.tld
        DocumentRoot "/var/www/obm/php"

        SSLVerifyClient none
        SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown downgrade-1.0 force-response-1.0

        ErrorLog /var/log/apache2/obm-error.log
        CustomLog /var/log/apache2/obm-access.log combined

        SetEnv OBM_INCLUDE_VAR obminclude
        Alias /images /var/www/obm/resources
        #OBM 2.2.x use utf8
        #AddDefaultCharset ISO-8859-15
        DirectoryIndex obm.php
        Options -Indexes

        php_value include_path  ".:/var/www/obm/"
        php_value session.bug_compat_42  0
        php_value session.bug_compat_warn  0
        #php_value session.gc_maxlifetime 2880
        php_value magic_quotes_gpc  On
        #les options suivantes sont recommandées ma facultative
        #php_value memory_limit 128M
        #php_value post_max_size 10M
        #php_value upload_max_filesize 10M

        # section nécessaire uniquement pour le synchro PDA
        #<Location /funambol>
        #ProxyPass ajp://_TOMCAT_SERVER_:8009/funambol
        #</Location>

        # section nécessaire uniquement pour le module obm-sync
        #<Location /obm-sync>
        #ProxyPass ajp://_TOMCAT_SERVER_:8009/obm-sync
        #</Location>

        # section nécessaire uniquement pour le webmail minig
        #<Location /minig>
        #ProxyPass ajp://_TOMCAT_SERVER_:8009/minig
        #</Location>
        # alias /webmail/images /usr/lib/minig/images
        #If you install minig on an other server,
        #comment alias /webmail/images, and use
        #proxyPass ajp:
        #<Location /webmail/images>
        #ProxyPass ajp://_TOMCAT_SERVER_Minig:8009/minig/images
        #</Location>
</VirtualHost>
</code>

Activer le virtualhost et relancer apache :
<code>
sudo ln -s /etc/apache2/sites-avalaible/obm /etc/apache2/sites-enable/obm
sudo /etc/init.d/apache2 reload
</code>

==== Configurer la base de données ====

Créer une base de données ('obm'), un utilisateur ('obm') qui aura tous les droits sur la base. Utiliser pour cela [[phpmyadmin|phpmyadmin]] ou saisir dans une console :

<code>
mysql -u root -p
mysql> CREATE USER 'test'@'localhost' IDENTIFIED BY 'password';
mysql> CREATE DATABASE IF NOT EXISTS `obm` ;
mysql> GRANT ALL PRIVILEGES ON `obm` . * TO 'obm'@'localhost';
mysql> exit
</code>

Créer les tables et importer les données par défaut :

<code>
/var/www/obm/scripts/2.2/install_obmdb_mysql_2.2.sh obm obm password fr
</code>
(syntaxe : [...]/install_obmdb_mysql_2.2.sh db user password lang)

==== Configurer obm ====

Il faut éditer le fichier ''/var/www/obm/conf/obm_conf.ini'' et modifier les valeurs suivantes :

<code>
external-url = obm.mondomaine.tld
external-protocol = https
...
dbtype = MYSQL
db = obm
user = obm
password = "password"
...
; Enabled OBM module
obm-ldap = false
obm-mail = false
...
; backupRoot is the directory used to store backup data
backupRoot = "/var/backups/obm/"
</code>

Il faut encore créer le répertoire pour les sauvegardes :
<code>
mkdir /var/backups/obm
chown www-data /var/backups/obm
</code>

Normalement, tout devrait fonctionner, vous pouvez passer à l'étape suivante.


===== Utilisation =====

Accéder à l'interface OBM : https://obm.mondomaine.tld/

Il faut impérativement créer un premier domaine puis un administrateur du domaine. Le domaine global n'est qu'un domaine à usage technique pour l'administrateur global d'OBM, il ne devrait normalement pas contenir d'utilisateur.

suite à venir

===== Désinstallation =====

<note warning>Incomplet</note>

Nettoyage de la base de données
<code>
mysql -u root -p
mysql> DROP USER 'obm'@'localhost';
mysql> DROP DATABASE `obm` ;
mysql> exit
</code>

===== Liens =====

  * [[wpfr>OBM_Groupware|OBM Groupware sur Wikipedia]]
  * [[http://obmpro.org/|Site communautaire]] et [[http://obm.org/doku.php?id=tools:ml|Mailing-list]] (anglais et français)
  * Cette solution bénéficie d'un [[http://obmpro.aliasource.fr/|support technique pour les professionnels]].

----

//Contributeurs : [[:utilisateurs:philoux99]].//